home *** CD-ROM | disk | FTP | other *** search
/ Network CD 2 / Network CD - Volume 2.iso / programs / internet / mail / mm_v0.1.lha / PutMail.lha / PutMail.doc < prev   
Encoding:
Text File  |  1995-04-15  |  4.9 KB  |  159 lines
  1.  
  2. GetMail - Version 1.1
  3.  
  4.  
  5. INTRODUCTION:
  6.  
  7. GetMail is a POP Client, it is used for receiving mail to your
  8. local Amiga host from an Internet POP host.
  9.  
  10. GetMail was written with referance to the following mail RFC's.
  11. RFC-821, RFC-822, RFC-1081, RFC-1082, RFC-1225, RFC-1725.
  12.  
  13.  
  14. REQUIREMENTS:
  15.  
  16. Getmail requires WB 2.04 as a minimum (and will also utilise the
  17. file buffering of WB 3.0 where possible).
  18.  
  19. GetMail is for use with AmiTCP (it will not work with AS225), it
  20. was developed on version 4.0 of AmiTCP but I suspect that it will
  21. work on version 3.0 also.
  22.  
  23.  
  24. BACKGROUND:
  25.  
  26. When I signed up to get Internet access I keenly downloaded software
  27. from my local BBS and was immediately disapointed while reading the
  28. installation instructions.  It was quite clear that much of the
  29. software was ported from the Unix/UUCP environment as the software
  30. wanted a lot of assigns like UULib:, UUSpool: and many environmental
  31. variables.  Even worse, several software packages used the 
  32. environmental variables in conflicting mannors.  The Ported Unix
  33. code did not take full advantage to the Amiga OS and resulted in 
  34. large executable sizes.  I decided to write my own utilities.
  35.  
  36.  
  37. INSTALLATION:
  38.  
  39. I have provided both 68000 and 68020 executables.
  40.  
  41. Simply copy the GetMail executable (this is a dos command so no icon is
  42. required) to a library somewhere in your path.  A good place for it is
  43. in the AmiTCP:bin drawer.
  44.  
  45. I reccommend creating two environmental variables called EMAILADDR and
  46. POPHOST.  EMAILADDR is for your full E-Mail address (Also used by PutMail).
  47. POPHOST is for the host name of the POP Host that holds your E-Mail mailbox.
  48. These assigns are not manditory but they do reduce the arguments that
  49. you need to pass to GetMail.
  50.  
  51. Thats all (GetMail does obtain other details required for correct
  52. operation directly from AmiTCP), provided AmiTCP is up and running
  53. you can use GetMail immediately.
  54.  
  55.  
  56. OVERVIEW:
  57.  
  58. GetMail receives mail to the local AmiTCP user's HOME directory.
  59. The local file is "From " delimited (same as AmiPOP).
  60.  
  61.  
  62. USAGE:
  63.  
  64. The command template for GetMail is "GetMail MAIL=MAILFILE/K,
  65. USER/K,PASS=PASSWORD/A,EMAILADDR/K,POPHOST/K,VERBOSE/S".
  66.  
  67. Lets go through the arguments one by one.
  68.  
  69. MAIL=MAILFILE  Optional argument.
  70.  
  71. This is the name of your local mail message file that you want to
  72. transmit.  (Normally this will be the name of a tempory file
  73. from you E-Mail program.)  The argument can be specified as
  74. MAILFILE=foobar or abreviated as MAIL=foobar.
  75.  
  76.  
  77. USER           Optional argument.
  78.  
  79. This is the UserID you use to access the POP Host.  If you don't
  80. provide this argument your local AmiTCP UserID will be used.
  81.  
  82.  
  83. PASS           Manditory argument.
  84.  
  85. This is the password you use to access the POP Host.
  86.  
  87.  
  88. REPLYTO        Optional argument.
  89.  
  90. This is the correct E-Mail address that should be used to send E-Mail
  91. replies to you.  If you omit this argument GetMail will use the EMAILADDR
  92. environmental variable, if that does not exist your AmiTCP UserID & SMTP
  93. host name will be used to create the ReplyTo address (unless you don't
  94. want GetMail to create header details).
  95.  
  96. SMTPHOST       Optional argument.
  97.  
  98. This is the name of the SMTP host that you transmit out through (and
  99. should ideally be the host that holds your mailbox).  If this argument
  100. is not supplied GetMail will use the environmental variable SMTPHOST,
  101. if that doesn't exist it will use the name of the host that you are
  102. connected to (obtained from the domain part of the local host name).
  103.  
  104. NOHEAD         Optional argument.
  105.  
  106. GetMail will put your local heading on the top of all messages unless
  107. you specify not to with this switch.  The local heading comes from the
  108. ".header" file in your home directory.
  109.  
  110. NOADDR         Optional argument.
  111.  
  112. This switch tells GetMail not to insert lines for "From:", "Date:",
  113. "To:", "ReplyTo:" and "Subject:" into the message header.
  114.  
  115. NOSIG          Optional argument.
  116.  
  117. GetMail will put your local signature at the bottom of all messages unless
  118. you specify not to with this switch.  The local signature comes from the
  119. ".signature" file in your home directory.
  120.  
  121. VERBOSE        Optional argument.
  122.  
  123. This argument simply switches on verbose reporting of the program's
  124. activities and progress.  If you have problems using GetMail this may
  125. help explain why it's not working.  You can always redirect the verbose
  126. output to a file and post this to be if you need assistance.
  127.  
  128.  
  129.  
  130. DEVELOPMENT:
  131.  
  132. GetMail was developed on an Amiga 3000 running WB 3.1 using SAS/C 6.51.
  133.  
  134.  
  135. SO LONG AND THANKS FOR THE FISH:
  136.  
  137. I hope you find GetMail easy to use and usefull.
  138.  
  139. Bug reports, Comments, ideas, *POSTCARDS*, E-Mail, gifts and requests
  140. for new utilities all welcome.
  141.  
  142. -------------------------------------------------------------------------
  143.  
  144. This program is freeware, use and/or distribute as you wish
  145. on a "NON Profit" basis.
  146.  
  147. No warranty exists, use this software at your own risk.
  148.  
  149. Martin V Lanza
  150. PO Box 8344,
  151. Christchurch,
  152. New Zealand.
  153.  
  154. mlanza@southern.co.nz
  155.  
  156. Home Phone 64-3-366-1618
  157.  
  158. (Amiga Fidonet echo areas also monitored)
  159.